home *** CD-ROM | disk | FTP | other *** search
/ Whiteline: delta / whiteline CD Series - delta.iso / tools / utils / duhr_112 / d_uhr112.txt next >
Text File  |  1995-11-25  |  15KB  |  382 lines
  1.  
  2.  
  3.                                  Die Uhr
  4.  
  5.  
  6.                      Eine Digitaluhr als Accessory
  7.  
  8.                      Die Dokumentation vom 30.03.93
  9.  
  10.  
  11.                    *Pentagramm Software Braunschweig
  12.              
  13.               Thomas Birke                 Hinnerk Rümenapf
  14.               birke@bii.bessy.de           Ottweilerstr. 18
  15.                                            38116 Braunschweig
  16.  
  17.  
  18.  Ein Programm von Thomas Birke & Hinnerk Rümenapf
  19.  (C) 1987 - 1993 T.B. & HWR
  20.  
  21.  Die Uhr  darf von jedem angewendet werden, der sie an jeden
  22.  weitergibt, der sie vielleicht anwenden möchte.
  23.  Die Uhr  darf NUR KOMPLETT weitergegeben werden, also mit den
  24.  UNVERÄNDERTEN Dateien:
  25.  
  26.         - DIE_UHR.ACC           Das Accessory
  27.         - D_UHR112.TXT          Diese Datei
  28.  
  29.         - UHRCONF.PRG           Konfigurationsprogramm für  Die Uhr
  30.         - UHRCONF.RSC           Resource-Datei dazu
  31.  
  32.  Alle Rechte liegen bei den Autoren.
  33.  
  34.  Wir übernehmen keine Garantie.
  35.  Wir haften -nicht- für Schäden, die durch Fehlfunktion, korrekte Funktion,
  36.  das Kopieren oder durch die bloße Existenz der Programme entstehen.
  37.  
  38.  
  39.  Geschichte(n)
  40.         Die Uhr  begann ihr Dasein als erster Test 'Wir stricken uns ein
  41.         Accessory'. In den folgenden Jahren wurde sie ständig den geänderten
  42.         Anforderungen angepasst.
  43.         Übrigens ... wir benutzen sie selber (immer noch!).
  44.  
  45.  
  46.  Die Uhr  ist noch so eine Uhr als Accessory, aber mit einigen Vorteilen :
  47.  
  48. EXTRA     Version 1.12   März '93
  49. =====   - Bildschirmschoner (z.B. Before Dawn) werden erkannt und nicht
  50.           beim Schonen gestört (wenn sie einen entsprechenden 'cookie'
  51.           intsallieren).
  52.  
  53. Jetzt Neu!   Version 1.1 Nov/Dez 1992    (hier nur die wichtigsten Änderungen)
  54. ==========                      (englischsprachige Version 1.1E ist vorhanden)
  55.  
  56.         - Ziffern und X-Position der Zeitanzeige können konfiguriert werden
  57.  
  58.         - Ein 12-Stunden Modus (am/pm) nach englischer Art wurde eingeführt
  59.         
  60.         - Das laufende Accessory kann OHNE RESET neu konfiguriert werden, ver-
  61.           änderungen der Anzeigeart werden sofort übernommen.
  62.           
  63.         - Ein paar kleine Fehlerkorrekturen, über die wir nicht weiter reden.
  64.  
  65.  
  66. Version 1.0  Juni/Juli 1992
  67.  
  68.         - Ein reines GEM-Programm, es werden keine Vektoren verbogen oder
  69.           Interrupt-Routinen installiert.
  70.  
  71.         - Eine kleine, uns wohlbekannte, Melodie zu jeder vollen Stunde
  72.           (abschaltbar).
  73.  
  74.         - Unterstützt jede Bildschirmauflösung (Ausgabe über das VDI).
  75.  
  76.         - Auch ein Wechsel der Auflösung ohne Reset (z.B. von AS-Overscan)
  77.           wird erkannt und behandelt.
  78.  
  79.         - Die Weckfunktion hat ein 'Zeit-Fenster'. Wenn unsaubere Programme
  80.           die Accessories nicht immer zum Zuge kommen lassen wird auch noch
  81.           innerhalb einer halben Stunde nach der eigentlichen Weckzeit der
  82.           Wecker gestartet, wenn  Die Uhr  bis dahin noch keine Gelegenheit
  83.           dazu hatte (danach ist der Zug eh' abgefahren).
  84.  
  85.         - Speichersparend durch externes Konfigurationsprogramm.
  86.  
  87.         -  Die Uhr  ist konfigurierbar, es läßt sich z.B. voreinstellen :
  88.              -- Woraus soll  Die Uhr  die Uhrzeit bestimmen ?
  89.              -- Soll die Uhrzeit angezeigt werden ?
  90.              -- Soll zur vollen Stunde die (kurze!) Melodie gespielt werden ?
  91.              -- Wie oft soll die Uhrzeit neu bestimmt werden ?
  92.               . . .
  93.  
  94.         - Das Konfigurationsprogramm und  Die Uhr  arbeiten mit "Let 'em fly"
  95.           von Oliver Scheel zusammen.
  96.  
  97.  
  98.  
  99. Soviel zum Eigenlob, nun zur Beschreibung :
  100.  
  101.  
  102.  0. GEM-Accessories
  103.  ------------------
  104.  
  105. Die Accessories sind Hilfsprogramme, die bei jedem Systemstart
  106. (z.B. Einschalten, Reset) vom Bootlaufwerk geladen werden. Sie laufen 'fast'
  107. parallel zu GEM - Programmen (wenn diese anständig programmiert sind).
  108. Sollte  Die Uhr  einmal mitten bei Ihrer Arbeit stehenbleiben, kann das
  109. verschiedene Gründe haben :
  110.  
  111.   In GEM - Programmen (Endung .PRG oder .APP) :
  112.         Der Programmierer hat die Accessories vergessen, oder er gönnt
  113.         ihnen keine Rechenzeit. Nach Beenden des Programmes sollte
  114.          Die Uhr  mit der richtigen Uhrzeit weiterlaufen.
  115.  
  116.   In TOS - Programmen (Endung .TOS oder .TTP) :
  117.         Hier kann  Die Uhr  nicht weiterlaufen, während dieser Programme ist
  118.         sie gestoppt. Nach Beenden des Programmes sollte  Die Uhr  mit der
  119.         richtigen Uhrzeit weiterlaufen.
  120.  
  121.  Die Uhr  ist über den gleichnamigen Menüpukt zum Menütitel ganz links zu
  122. erreichen. Wenn Sie diesen Menüpunkt anwählen wird eine Dialogox dargestellt,
  123. in der Sie verschiedene Einstellungen vornehmen können (siehe unten).
  124.  
  125. Wenn Ihr Rechner nicht mit einer Hardware-Uhr ausgestattet ist, müssen Sie
  126. die Uhrzeit wohl von Hand stellen, z.B. mit dem Kontrollfeld, oder einem
  127. extra-Programm (z.B.  D_T.PRG ).
  128.  
  129.  
  130.  1. Zeitanzeige
  131.  --------------
  132.  
  133. Die Uhrzeit wird rechts oben in der Menüleiste angezeigt. Auch wenn die Bild-
  134. schirmauflösung sich ändert (z.B. AS-Overscan) bleibt der eingestellte Abstand
  135. zum rechten Bildrand konstant.
  136.  
  137. Wahlweise wird eine 24- oder eine 12- Stunden Anzeige dargestellt. 
  138. Die 12-Stunden Anzeige ergänzt die Ziffern durch einen Buchstaben: "a" für
  139. Vormittag, und "p" für Nachmittag, wie in englischsprachigen Ländern üblich.
  140.  
  141. Ist zusätzlich zur Zeitanzeige auch der Wecker eingeschaltet, wird rechts
  142. neben der Uhrzeit ein kleines Glockensymbol ausgegeben.
  143.  
  144.   Extrabreite Menüzeilen
  145.         Manche Programme nutzen die gesamte Bildbreite für ihre Menüzeile
  146.         aus. In diesem Fall wird der letzte Menüpunkt von der Zeitanzeige
  147.         übermalt, was aber lediglich ein Schönheitsfehler ist, das Menü
  148.         funktioniert trotzdem einwandfrei.
  149.  
  150.   TEMPUS
  151.         Sie können in den üblichen ST-Bildschirmauflösungen die Zeitanzeige
  152.         an der selben Stelle wie die TEMPUS-Uhr ausgeben lassen, auch in nicht
  153.         allzustark erweiterten Bildschirmauflösungen geht das problemlos.
  154.         
  155.         Die Einstellung ist aber nicht für alle Bildschirmauflösungen korrekt,
  156.         denn die Anzeige der TEMPUS-Uhr behält ihre X-Position, während
  157.          Die Uhr  ihre Zeitanzeige entsprechend der Änderung der Bildbreite 
  158.         verschiebt.
  159.         Die TEMPUS-Uhr wird mit  ALTENATE '  abgeschaltet, für  Die Uhr
  160.         siehe unten.
  161.  
  162. In der Dialogbox wird die Zeitanzeige mit den Knöpfen neben dem Uhrsymbol
  163. an- oder ausgeschaltet.
  164. Die Voreinstellung Zeitanzeige Ein/Aus ist konfigurierbar.
  165.  
  166.  
  167.  2. Melodie zur vollen Stunde
  168.  ----------------------------
  169.  
  170. Zuhören und sich freuen, oder diese Option abschalten.
  171.  
  172. Immer wenn sich die Stunde ändert, kann  Die Uhr  eine kurze Melodie (naja,
  173. nur 8 Töne) spielen.
  174.  
  175. In der Dialogbox wird die Melodie zur vollen Stunde mit den Knöpfen neben der
  176. kleinen Note an- oder ausgeschaltet.
  177. Die Voreinstellung Melodie zur vollen Stunde Ein/Aus ist konfigurierbar.
  178.  
  179.  
  180.  3. Wecker
  181.  ---------
  182.  
  183. Um geweckt zu werden ...
  184.  
  185.   - In der Menüleiste den Eintrag 'Die Uhr' anklicken, die Dialogbox wird
  186.     dargestellt.
  187.  
  188.   - Mit den Knöpfen neben dem Glockensymbol wird der Wecker an- und ausge-
  189.     schaltet. Klicken Sie den Knopf  'An'  (rechts neben dem Glockensymbol)
  190.     an.
  191.  
  192.   - unten in der Dialogbox ist das Eingabefeld für die Weckzeit. Tragen Sie
  193.     hier also die gewünschte Weckzeit ein (Backspace, Delete löschen).
  194.     
  195.     Auch bei der Weckzeit wird zwischen 12- und 24 Stunden Modus
  196.     unterschieden:
  197.     
  198.     24-Stunden Modus
  199.     ================
  200.        Es müssen IMMER 4 ZIFFERN eingegeben werden, zum Beispiel :
  201.        
  202.            Zeit               Anzeige im Eingabefeld
  203.          --------------------------------------------
  204.          Ein Uhr zwölf                01:12
  205.          Neun Uhr drei                09:03
  206.          Vierzehn Uhr fünf            14:05
  207.          10 Minuten nach Mitternacht  00:10
  208.                    
  209.     12-Stunden Modus
  210.     ================
  211.        In diesem Modus werden zusätzlich unter dem Eingabefeld zwei Knöpfe
  212.        angezeigt, der eine ist mit  AM  bezeichnet, der andere mit  PM .
  213.        
  214.        Es müssen auch hier immer 4 Ziffern eigegeben werden, zusätzlich dazu
  215.        müssen Sie einen der der beiden Knöpfe AM/PM anklicken, zum Beispiel:
  216.  
  217.            Zeit               Anzeige im Eingabefeld     angeclickt
  218.          -----------------------------------------------------------
  219.          Ein Uhr zwölf                01:12                 AM
  220.          Neun Uhr drei                09:03                 AM
  221.          Vierzehn Uhr fünf            02:05                 PM
  222.          10 Minuten nach Mitternacht  12:10                 PM
  223.  
  224.  
  225.     Klicken Sie danach den Knopf 'OK' an, die Dialogbox wird geschlossen.
  226.  
  227.     Wenn  Die Uhr  mit Ihrer Eingabe nichts anfangen kann macht sie Sie
  228.     darauf aufmerksam, und die Dialogbox wird erneut geöffnet.
  229.     Gehen Sie dann zurück, zur Eingabe der Weckzeit.
  230.  
  231. Sind Wecker UND Zeitanzeige eingeschaltet, wird rechts neben der Uhrzeit
  232. ein kleines Glockensymbol ausgegeben.
  233.  
  234. Wenn Sie es sich anders überlegen, und doch lieber ausschlafen wollen, öffnen
  235. Sie wieder die Dialogbox (über den Menüpunkt 'Die Uhr'), und klicken Sie den
  236. Knopf 'Aus' -rechts neben dem Glockensymbol!- an.
  237.  
  238. Wie schon in den Allgemeinen Bemerkungen über Accessories erwähnt, ist nicht
  239. sichergestellt, daß  Die Uhr  immer Rechtzeitig zum Wecken vom AES etwas
  240. Rechenzeit zur Verfügung gestellt bekommt. Damit die Weckfunktion trotzdem zu
  241. etwas nütze ist weckt Sie  Die Uhr  auch noch innerhalb einer halben Stunde
  242. nach der eingestellten Weckzeit -- wenn sie vorher noch keine Gelegenheit dazu
  243. hatte.
  244.  
  245.  
  246.  4. Woher  Die Uhr  die Uhrzeit hat
  247.  ----------------------------------
  248.  
  249. Das Betriebssystem dieses Rechners hat eine vielschichtige Art die Zeit zu
  250. messen.  Die Uhr  kann sich mehrerer Möglichkeiten bedienen, um zu er-
  251. fahren wie spät es ist. Die Einstellung, welche dieser Arten nun verwendet
  252. werden soll, wird unter 5. beschrieben.
  253.  
  254. Alle diese Methoden haben so ihre Vor- und Nachteile :
  255.  
  256.   TIMER
  257.         Beim Starten des Accessorys wird EINMAL die GEMDOS-Uhr abgefragt,
  258.         danach wird die vergangene Zeit aus dem 200 Hertz Systemtimer
  259.         berechnet.
  260.  
  261.         Daraus folgt, daß  Die Uhr  nichts davon merkt, wenn die System-
  262.         Uhrzeit verändert wird. Darum wird beim Öffnen der Dialogbox die
  263.         GEMDOS-Uhr abgefragt, und  Die Uhr  erneut nach der GEMDOS-Uhr
  264.         gestellt.
  265.         Sollte also  Die Uhr  etwas anderes als die GEMDOS-Uhrzeit anzeigen
  266.         einfach die Dialogbox über die Menüzeile öffnen, und wieder schließen.
  267.  
  268.         ( Es soll Programme geben, die den 200 Hertz Timer setzen. Sollte das
  269.           passieren,  zeigt  Die Uhr  natürlich Blödsinn an.
  270.           [ Welche Programme sollten das tun ?  Warum ??  WIE ??? ]
  271.           Sollte Ihnen so etwas begegnen verfahren Sie wie oben beschrieben. )
  272.  
  273.   XBIOS
  274.         in Rechnern ohne extra Hardware-Uhr (1040 STF[M], 1040 STE, ... )
  275.         wird über das XBIOS die Uhr im Tastaturprozessor abgefragt.
  276.         Das verhindert das der Bildschirmschoner von MACCEL3 anspricht.
  277.  
  278.         In Rechnern MIT HARDWAREUHR ab Werk (MEGA ST[E], ...) empfehlenswert.
  279.  
  280.   GEMDOS
  281.         Die Uhrzeit beim GEMDOS zu erfragen hat auch einen Nachteil :
  282.  
  283.         DAS PROBLEM :
  284.         Wenn eine dieser netten Meldungen "Laufwerk X antwortet nicht ..."
  285.         auf dem Bildschirm erscheint, hat irgendein Programm das GEMDOS
  286.         aufgerufen, das GEMDOS wiederum das BIOS (oder XBIOS ?), dieses
  287.         wiederum das AES, welches uns mit diesen wundervollen Meldungen
  288.         erfreut. Wenn nun das AES aktiv ist läßt es  Die Uhr  auch mal an
  289.         die Reihe, allerdings ist der ursprüngliche GEMDOS-Aufruf noch nicht
  290.         beendet. Wenn nun  Die Uhr  die GEMDOS-Uhr abfragt, bevor der ur-
  291.         sprüngliche GEMDOS-Aufruf beendet ist, stürzt das ganze ab.
  292.  
  293.         Um diese Gefahrenquelle auszuschalten, wird vor jeder GEMDOS-Zeitab-
  294.         frage die AES-Funktion  WindowUpdate ( 1 )  aufgerufen, danach
  295.         WindowUpdate ( 0 ). Dadurch muß die Uhr warten, bis das AES
  296.         Dialogboxen oder Menüs fertig behandelt hat.
  297.  
  298.         NACHTEIL :
  299.         Solange ein Programm mit  WindowUpdate  das AES zurückhält, steht
  300.          Die Uhr  (z.B. solange Dialogboxen geöffnet sind, oder Fenster neu
  301.         gezeichnet werden).
  302.  
  303.  
  304.  5. Konfiguration
  305.  ----------------
  306.  
  307. Falls Sie mit der Standardeinstellung nicht zufrieden sind, können Sie sie
  308. mit  UHRCONF.PRG  verändern.
  309.  UHRCONF.PRG  wurde als extra-Programm geschrieben, damit das Accessory nicht
  310. unnötig lang wird.
  311.  
  312. Nachdem Sie  UHRCONF.PRG  gestartet haben, übernimmt das Programm alle
  313. Einstellungen aus dem Accessory (falls es beim Systemstart geladen wurde).
  314.  
  315. Sie können nun in der angezeigten Dialogbox alle Einstellungen nach Ihren
  316. Vorstellungen ändern.
  317.  
  318. Wenn eine Änderung das Aussehen der Zeitanzeige betrifft, wird  Die Uhr ,
  319. falls aktiv, sofort darauf reagieren.
  320.  
  321.   LADEN 
  322.         Die Einstellungen aus der Datei  DIE_UHR.ACC  werden gelesen und
  323.         anzeigt. Ist  Die Uhr  aktiv, werden die geladenen Einstellungen vom
  324.         laufenden Accessory übernommen.
  325.  
  326.   SPEICHERN
  327.         Die momentan angezeigten Einstellungen werden in die Datei  
  328.          DIE_UHR.ACC  geschrieben.
  329.         Nur die so geschriebenen Einstellungen bleiben auch nach einem
  330.         Neustart des Rechners (z.B. Reset) erhalten.
  331.         
  332.   OK
  333.         Beendet das Programm.
  334.         
  335.  
  336. Sollte  UHRCONF.PRG  mit einer älteren oder jüngeren Accessory-Version
  337. konfrontiert werden, wir es Ihnen das mitteilen. Es können dann nicht alle
  338. Einstellungsmöglichkeiten genutzt werden.
  339.  
  340.  
  341.  
  342.  
  343. ANHANG A: Der Patchbereich     (für die ewig Neugierigen)
  344. --------------------------
  345.  
  346. Beispiel für einen gültigen Patchbereich:
  347.  
  348.  &Die_Uhr_Vars:TZM2k1pS& 
  349.                ||||||||
  350.                |||||||+- S : Siebensegment Ziffern
  351.                |||||||   s : normale Ziffern
  352.                |||||||
  353.                ||||||+- P : 12-Stunden Anzeige in englischer Notation
  354.                ||||||   p : 24-Stunden Anzeige
  355.                ||||||
  356.                |||||+- "1" bis "9" : Abstand zum rechten Bildschirmrand
  357.                |||||                 (in Zeichenbreiten)
  358.                |||||
  359.                ||||+-- K : Anzeige kursiv (schräggestellt)
  360.                ||||    k : Anzeige normal (gerade)
  361.                ||||
  362.                |||+--- "1" bis "9" : Soviele Sekunden wird gewartet, bis
  363.                |||                    Die Uhr  erneut die Uhrzeit bestimmt.
  364.                |||
  365.                ||+---- M : Melodie zur vollen Stunde  AN
  366.                ||      m : ----------  "  ----------  AUS
  367.                ||
  368.                |+----- Z : Zeitanzeige AN
  369.                |       z : ---  "  --- AUS
  370.                |
  371.                +------ T : 200 Hz - Timer zur Zeitbestimmung benutzen.
  372.                        X : XBIOS - Uhr abfragen
  373.                        G : GEMDOS - Uhr abfragen     [ siehe dazu 4. ]
  374.  
  375.  
  376.  
  377.  Dokumentation von Hinnerk Rümenapf.
  378.  
  379.  (Schreib- und andere Fehler vorbehalten.)
  380.  
  381. +++
  382.